== How to Use Boutique ==

This document gives some advice to end users about how to use Boutique. You may
wish to copy and paste this information onto your server's website, but since
Boutique is reasonably configurable, it may not provide information 
specific enough to your installation. Feel free to edit the information
contained in this document before pasting it, and you needn't bother to list me 
as an author either. (The plugin is released under a rather strict license only
because I can't be bothered to research different licenses.)

The document is organised into talking about useful commands for everyone, for
buyers, and then sellers. It must not be thought that "buyer" and "seller" are
classes that are picked by players, it is simply a way to explain how to use the
plugin.
The next section talks about admins, and the final section lists the commands

=== Everyone ===
Access help information with the following commands:

	/shop help
	/shop commands
	/shop aliases

'/shop help' displays a list of the commands for which you have permissions, and
displays what the commands do.

'/shop commands' displays a list of the commands for which you have permission.

'/shop aliases' displays a list of the commands for which you have permission,
followed by alternative, often shorter, words that can be used instead. An
example is '/shop o' which is short for '/shop o'

=== Buyers ===
There are four useful commands:

      /shop list
      /shop go [user]

/shop list gives you a list of shops, and a description of each of these shops.
In some configurations, and/or if the list is heavily populated, the description
will be omitted.

/shop go [user] may allow you to teleport to the shop belonging to [user],
depending whether you are permitted to by the server's admin. This command may
instead send a request to the owner of the shop, and they will decide whether
you are allowed to teleport there. You will be teleported there if they decide
to accept your request. 

=== Sellers ===
There are as many as ten useful commands:

      /shop create
      /shop open
      /shop close
      /shop
      /shop edit location
      /shop edit description
      /shop edit reset
      /shop delete
      /shop accept
      /shop deny.

If you have been allowed to, you can create a shop using
'/shop create [description]'. You may have only one shop at a time, and each
time you use /shop create, your previous shop's details will be overwritten.
[description] may be optional, required or forbbiden by your admin. When you
create a shop when you didn't have one already, your shop will be set to closed

Your shop can be opened and closed using '/shop open' and '/shop close' as long
as you have been granted permission to do so. Depending on the configuration on
your server, whether your shop is open or closed affects whether you appear in
the '/shop list', or whether and how people can teleport to your shop.

'/shop' may allow you to teleport to your own shop, depending on the whether you
are premitted to do so.

'/shop edit' is used to edit your shop. '/shop edit location' will change only
the teleport destination of your shop, whilst
'/shop edit description [description]' will change only the description.
'/shop edit reset [description]' will change both of these things

'/shop delete' will delete your shop permenantly. It is possible for this option
to be disabled - you may have to ask an admin to delete it for you.

Finally, '/shop accept' and '/shop deny' are the commands used to accept or deny
a teleport request to your shop. You will only need to use these when a message
appears on-screen informing you of the choice. On some configurations, these
commands will never need to be used because request teleporting may not be
set up by the admin.

===  Admins ===
Admins, as of 2.0, have special permissions. This allows them to teleport to
anyone's shop at any time, and also to delete shops. This is depend on whether
admins have been granted this permission.

you can list admins commands with /shop admin, though the only command currently
available is /shop admin delete [player], which deletes [player]'s shop.

= End =

